home *** CD-ROM | disk | FTP | other *** search
/ SGI MIPSpro Fortran-77 7.2 / SGI MIPSpro Fortran-77 7.2.iso / docs6.4 / relnotes / ftn77_fe / ch4.z / ch4
Text File  |  1997-09-04  |  10KB  |  330 lines
  1.  
  2.  
  3.  
  4.                                                - 1 -
  5.  
  6.  
  7.  
  8.                     7.2 Fortran 77 Front-End Release Notes
  9.  
  10.  
  11.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                - 2 -
  70.  
  71.  
  72.  
  73.                     DDDDooooccccuuuummmmeeeennnntttt NNNNuuuummmmbbbbeeeerrrr 000000007777----1111666655559999----000011110000
  74.  
  75.  
  76.                     4.  _N_e_w__F_e_a_t_u_r_e_s__o_f__T_h_i_s__R_e_l_e_a_s_e
  77.  
  78.                     This chapter contains the differences between
  79.                     this release and the 7.1 release of MIPSpro
  80.                     Fortran 77 compiler.
  81.  
  82.  
  83.                     4.1  _R_e_p_a_c_k_a_g_i_n_g__o_f__F_r_o_n_t_-_E_n_d__S_u_b_s_y_s_t_e_m_s
  84.  
  85.  
  86.                     The MIPSpro Fortran 77 front-end subsystems are
  87.                     now packaged on their own separate CD. Before
  88.                     installing the MIPSpro Fortran 77 Front-end
  89.                     subsystems you must first install compiler_dev,
  90.                     compiler_eoe, ftn_dev, and ftn_eoe from the IRIX
  91.                     Development Foundation CD. Should you desire to
  92.                     use the new 7.2 Fortran 77 runtime libraries,
  93.                     you must install patchSG0002016.ftn_dev_sw
  94.                     patchSG0002016.ftn_eoe_sw (*.sw64 subsystems are
  95.                     required only for 64-bit operation).
  96.  
  97.  
  98.                     4.2  _O_p_t_i_o_n__t_o__u_s_e__F_o_r_t_r_a_n__9_0__l_i_b_r_a_r_y
  99.  
  100.  
  101.                     The -_c_r_a_y_l_i_b_s option allows you to use the
  102.                     Fortran 90 library, libfortran.so, (based on the
  103.                     Cray FFIO library) to link your program.  Using
  104.                     this option requires installation of Patch 2016
  105.                     (available on the IRIX Development Foundation
  106.                     CD's).  Note that only standard Fortran 77 I/O
  107.                     operations are supported in this release.  If
  108.                     you use any SGI Fortran 77 extensions
  109.                     (particularly ISAM and variable formats) you
  110.                     cannot use the -_c_r_a_y_l_i_b_s option.
  111.  
  112.  
  113.                     4.3  _N_e_w__O_p_t_i_o_n_s__a_n_d__D_e_f_a_u_l_t_s
  114.  
  115.  
  116.                     A new -_D_E_B_U_G:_o_p_t_i_o_n control group has been
  117.                     created to allow insertion of code to assist in
  118.                     the debugging of programs.  For example,
  119.                     -_D_E_B_U_G:_d_i_v__c_h_e_c_k=_N replaces -_T_E_N_V:_c_h_e_c_k__d_i_v=_N
  120.                     and the 7.2 compiler, by default, inserts code
  121.                     to check for divide by zero (N=1).
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                                - 3 -
  136.  
  137.  
  138.  
  139.                     _N_O_T_E:  The default value for -_T_E_N_V:_c_h_e_c_k__d_i_v=_N
  140.                     under MIPSpro 7.1 was N=0 (no checks).
  141.  
  142.                     For more information, please refer to the _f_7_7(1)
  143.                     and _D_E_B_U_G__g_r_o_u_p(5) man pages.
  144.  
  145.                     The -_L_I_S_T: options control group has been
  146.                     enhanced to the create a listing file (.l) that
  147.                     contains the values of all flags  modified,
  148.                     directly in the command line, or indirectly as a
  149.                     side effect of other options. For example:
  150.  
  151.                     % f77 -n32 -LIST:options=ON foo.f
  152.  
  153.                     will create foo.l which contains a listing that
  154.                     contains the default values of certain options
  155.                     from the -OPT, -LNO, -TARG and -TENV option
  156.                     control groups.
  157.  
  158.                     The following command:
  159.  
  160.                     % f77 -n32 -LIST:all_options=ON foo.f
  161.  
  162.                     will create foo.l which contains a listing that
  163.                     contains the default values of all options from
  164.                     all of the option control groups.
  165.  
  166.                     For more information, please refer to the _f_7_7(1)
  167.                     man page.
  168.  
  169.  
  170.                     4.4  _O_b_s_o_l_e_t_e__O_p_t_i_o_n_s
  171.  
  172.  
  173.                     Several compile-time flags have been obsoleted.
  174.                     These include: -_T_E_N_V:_m_i_s_a_l_i_g_n_e_m_n_t=_N,
  175.                     -_T_E_N_V:_a_l_i_g_n__e_x_t_e_r_n=_N and -_T_E_N_V:_a_l_i_g_n_e_d=_T_R_U_E.
  176.                     Their use will generate a warning message in
  177.                     both the compiler front-end and backend. For
  178.                     example:
  179.  
  180.                     % f77 -n32 -TENV:misalignment=3 reshape.f
  181.                     Warning: Obsolete option "-TENV:misalignment=3" -- ignored
  182.                     Warning: Obsolete option "-TENV:misalignment=3" -- ignored
  183.  
  184.                     The -_T_E_N_V:_v_a_r_a_r_g_s__p_r_o_t_o_t_y_p_e_s=_T_R_U_E flag has been
  185.                     replaced by -_D_E_B_U_G:_v_a_r_a_r_g_s__p_r_o_t_o_t_y_p_e_s=_T_R_U_E.
  186.  
  187.                     For more information, please refer to the _f_7_7(1)
  188.                     and _D_E_B_U_G__g_r_o_u_p(5) man pages.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                - 4 -
  202.  
  203.  
  204.  
  205.                     4.5  _F_i_l_l__a_n_d__A_l_i_g_n__D_i_r_e_c_t_i_v_e__S_u_p_p_o_r_t
  206.  
  207.  
  208.                     MIPSpro 7.2 Fortran 77 supports new types of
  209.                     directives to facilitate padding and alignment
  210.                     of variables within cachelines and pages of
  211.                     memory. They are outlined below.
  212.  
  213.  
  214.                     c*$*    fill_symbol (s, L1cacheline)
  215.                     c*$*    fill_symbol (s, L2cacheline)
  216.                     c*$*    fill_symbol (s, page)
  217.                     c*$*    fill_symbol (s, <user-specified-power-of-two>)
  218.                     c*$*    align_symbol (s, L1cacheline)
  219.                     c*$*    align_symbol (s, L2cacheline)
  220.                     c*$*    align_symbol (s, page)
  221.                     c*$*    align_symbol (s, <user-specified-power-of-two>)
  222.  
  223.  
  224.                     The fill_symbol and align_symbol directives take
  225.                     a symbol (i.e. a variable that may be a Fortran
  226.                     COMMON, or an automatic variable, but not a
  227.                     formal and not an element of a structured type
  228.                     like a struct or an array).  The second argument
  229.                     in the directive may be one of the keywords
  230.                     L1cacheline (machine specific first-level cache
  231.                     line size, typically 32 bytes), L2cacheline
  232.                     (machine specific second-level cache line size,
  233.                     typically 128 bytes), page (machine specific
  234.                     page size, typically 16 Kbytes), or a user-
  235.                     specified power-of-two value.
  236.  
  237.                     The align_symbol directive aligns the start of
  238.                     the named symbol at the specified alignment,
  239.                     i.e. the symbol "s" will start at the specified
  240.                     alignment boundary.
  241.  
  242.                     The fill_symbol directive pads the named symbol
  243.                     with additional storage so that the symbol is
  244.                     assured not to overlap with any other data item
  245.                     within the storage of the specified size. The
  246.                     additional padding required is heuristically
  247.                     divided between each end of the specified
  248.                     variable. For instance, a fill_symbol directive
  249.                     for the L1cacheline will guarantee that the
  250.                     specified symbol will not suffer from false-
  251.                     sharing for the L1 cache line.
  252.  
  253.                     For global variables these directive must be
  254.                     specified at the variable definition, and are
  255.                     optional at the declarations of the variable.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                                - 5 -
  268.  
  269.  
  270.  
  271.                     For COMMON block variables these directive are
  272.                     required at each declaration of the COMMON
  273.                     block. Since the directive modify the allocated
  274.                     storage and its alignment for the named symbol,
  275.                     inconsistent directive can lead to undefined
  276.                     results.
  277.  
  278.                     The align_symbol directive is ineffective for
  279.                     local variables of fixed-size symbols, such as
  280.                     simple scalars or arrays of known size. The
  281.                     directive continues to be effective for stack-
  282.                     allocated arrays of dynamically-determined size.
  283.  
  284.                     A variable cannot have both fill_symbol and
  285.                     align_symbol directives applied to it.
  286.  
  287.  
  288.                     4.6  _N_e_w _A_u_t_o_m_a_t_i_c _P_a_r_a_l_l_e_l_i_z_a_t_i_o_n _O_p_t_i_o_n
  289.                          _P_r_o_d_u_c_t
  290.  
  291.  
  292.                     The 7.2 release of the MIPSpro compilers marks a
  293.                     major revision of the auto-parallelizer. The new
  294.                     product incorporates automatic parallelization
  295.                     into the other optimizations performed by the
  296.                     MIPSpro compilers.  Previous versions relied on
  297.                     preprocessors to provide source-to-source
  298.                     conversions prior to compilation. This change
  299.                     provides several benefits to developers:
  300.  
  301.                     Automatic parallelization is integrated with
  302.                     optimizations for single processors.
  303.  
  304.                     A set of options and pragmas consistent with the
  305.                     rest of the MIPSpro compilers.
  306.  
  307.                     Better run-time and compile-time performance.
  308.  
  309.                     For more information, please refer to the
  310.                     auto_p(5) man pages.
  311.  
  312.                     NOTE: In order to run the new automatic
  313.                     parallelization, you must purchase the MIPSpro
  314.                     Auto Parallelization Option (SC4-APO-7.2) and
  315.                     install the license for it (FEATURE name string
  316.                     = auto_pp).
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.